home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / pcboard / hb_mb11.zip / BRDMPPE.TXT < prev    next >
Text File  |  1996-01-02  |  9KB  |  227 lines
  1.  
  2.  
  3.                                 Multi-BRDM PPE
  4.                                 Copyright 1995
  5.                                 Herbert Bushong
  6.  
  7. ╔════════════════════════════════════════════════════════════════════════════╗
  8. ║ Copyright notice                                                           ║
  9. ╚════════════════════════════════════════════════════════════════════════════╝
  10. This product is released as Freeware, but the author retains all rights.
  11. It IS Copyrighted material. Altering, decompiling, or hacking this product
  12. is expressly forbidden without written permission from the author.
  13. It is guaranteed free of any backdoors or trojan code. If you feel you have a
  14. hacked copy, feel free to obtain an original from the author's support BBS.
  15.  
  16.  
  17. ╔════════════════════════════════════════════════════════════════════════════╗
  18. ║ Description                                                                ║
  19. ╚════════════════════════════════════════════════════════════════════════════╝
  20.  
  21. PCBoard has a LOT of commands available to users. Even more for sysops.
  22. Plus they can be stacked for even more power. The drawback to all this
  23. flexibility is that there is never enough room to place all the commands
  24. in 22 lines of the main menu (BRDM/BRDS). And menus that scroll off the screen
  25. are useless.
  26.  
  27. This PPE replaces your BRDM/BRDS screens and allows you to define multiple
  28. screens that can be rotated by the user. You can have as many screens as
  29. you want. If you use multiple "sysop" menus as well, the PPE automatically
  30. detects the "sysop" security level and displays the appropriate screens
  31. defined in the SDISPLAY.LST file. And it handles security changes (such
  32. as conference sysops) with ease.
  33.  
  34. You could have a screen of General commands, File Commands, and Message
  35. commands, or any combination imaginable.
  36.  
  37. THIS IS NOT A .MNU-TYPE ARRANGEMENT. All commands are available no matter
  38. what screen is shown. The ppe just displays the correct screen then
  39. exits.
  40.  
  41. ╔════════════════════════════════════════════════════════════════════════════╗
  42. ║ Files                                                                      ║
  43. ╚════════════════════════════════════════════════════════════════════════════╝
  44.  
  45. in archive-
  46.  
  47. FILE_ID .DIZ     Archive description
  48. BRDMPPE .TXT     This file
  49. HISTORY .TXT     History of changes
  50. BRDM    .PPE     Main PPE
  51. BRDUP   .PPE     Used to rotate Screens forward (will "wrap" around)
  52. BRDDOWN .PPE     Used to rotate Screens backward (will "wrap" around)
  53. DISPLAY .LST     List of normal user screens
  54. SDISPLAY.LST     List of Sysop screens
  55. FRDM    .        \
  56. GRDM    .         \
  57. MRDM    .          \ Sample screens
  58. FRDS    .          /
  59. GRDS    .         /
  60. MRDS    .        /
  61.  
  62. created by PPE-
  63.  
  64. NODE????.XXX    one for each node, used to record current user and screen
  65.                 PPE will automatically create and maintain these files
  66.                 as necessary.
  67.  
  68.  
  69. All files must reside in the PPE directory.
  70.  
  71. ╔════════════════════════════════════════════════════════════════════════════╗
  72. ║ Installation                                                               ║
  73. ╚════════════════════════════════════════════════════════════════════════════╝
  74.  
  75. There are 3 ways to install the main PPE. If your main menu is defined as
  76. BRDM in PCBSETUP, and you don't want to edit the path information, you can
  77. use the Simple method. If your menu isn't named BRDM and/or you want
  78. the Sysop screens supported as well, you are going to have to use the
  79. Complete method or the Include method.
  80.  
  81. My personal recommendation is to use the Include method <g>
  82.  
  83.                    ╓────────────────────────────────╖
  84.                    ║            Simple              ║
  85.                    ╙────────────────────────────────╜
  86.  
  87. Extract the contents of the archive to the directory where your BRDM file is
  88. located. Create your different screens (see Menu Display Files) and then
  89. edit the DISPLAY.LST (see Display List).
  90.  
  91. In PCBSETUP, add the BRDUP.PPE to your CMD.LST. If you don't know how,
  92. see your PCBoard Manual. Make the command intuitive for your users and
  93. name it UP or BUP. Whatever suits your style.
  94. If your want to be able to rotate the screens in either direction, also
  95. and another command for the BRDDOWN.PPE. Again, make it intuitive and name
  96. it DOWN or BDOWN.
  97.  
  98. **Note, this type of installation will not work for the sysop menus if they
  99. aren't named BRDM or your main menu isn't named BRDM. In either case,
  100. you must use the Complete or Include method instead.
  101.  
  102.  
  103.                    ╓────────────────────────────────╖
  104.                    ║            Include             ║
  105.                    ╙────────────────────────────────╜
  106.  
  107. Extract the archive into it's own directory. Create the displays and
  108. edit the *.LST files. Follow the instructions for adding the
  109. BRDUP/BRDDOWN.PPE's to your CMD.LST.
  110.  
  111. Edit your current users Menu (BRDM) file so that it contains 1 Line:
  112. !d:\path\BRDM.PPE
  113.  
  114. the ! must be in the first column, then the path and name of the PPE.
  115. You can edit the sysops menu (BRDS) file as well to include just the
  116. above line, if you want multiple sysop displays.
  117.  
  118. Delete any Graphic, Security, and Language variants of the BRDM/BRDS
  119. files.
  120.  
  121.  
  122.                    ╓────────────────────────────────╖
  123.                    ║           Complete             ║
  124.                    ╙────────────────────────────────╜
  125.  
  126. **There is a utility on Salt Air that should be able to make a "mass
  127. change" to your conference information if it is necessary.
  128.  
  129. Extract the contents or the archive to a directory. If you want to save
  130. some editing, place it in the same directory as your current BRDM file.
  131.  
  132. Create the various display screens (see Menu Display Files), and
  133. Edit the DISPLAY.LST file and the SDIPLAY.LST file (see Display List)
  134.  
  135. Add the BRDUP/BRDDOWN.PPE's to your CMD.LST as described in the Simple method.
  136.  
  137. While in PCBSETUP, your must check the settings on each of your conferences-
  138. page 1:
  139.  
  140.  Name/Loc of User's Menu     : D:\PCB\GEN\BRDM
  141.  Name/Loc of Sysop's Menu    : D:\PCB\GEN\BRDM
  142.  
  143. and change them to reflect the name/location of the PPE files.
  144.  
  145.  
  146. ╔════════════════════════════════════════════════════════════════════════════╗
  147. ║ Special Considerations                                                     ║
  148. ╚════════════════════════════════════════════════════════════════════════════╝
  149.  
  150.  
  151.                    ╓────────────────────────────────╖
  152.                    ║  Conf. Specific CMD.LST's      ║
  153.                    ╙────────────────────────────────╜
  154.  
  155. If your conferences use the same BRDM file, but have a conf. specific CMD.LST,
  156. you will need to add the BRDUP/BRDDOWN.PPE entries to each.
  157.  
  158.                    ╓────────────────────────────────╖
  159.                    ║  Conf. Specic BRDM/BRDS Files  ║
  160.                    ╙────────────────────────────────╜
  161.  
  162. If you have conferences that use different BRDM/BRDS files than the rest,
  163. you will need another installation of the PPE for each different BRDM.
  164. I'd recommend using the Include method.
  165.  
  166.  
  167.  
  168. ╔════════════════════════════════════════════════════════════════════════════╗
  169. ║ Display List  Files                                                        ║
  170. ╚════════════════════════════════════════════════════════════════════════════╝
  171.  
  172. There are 2 files which list the displays that are "rotated". The PPE uses
  173. one or the other depending on whether the current user has sysop priveledges
  174. at the time.
  175.  
  176. DISPLAY.LST contains the user menu filenames
  177. SDISPLAY.LST contains the sysop menu filenames
  178.  
  179.  
  180. The format for both files is:
  181.  
  182. 3
  183. d:\path\FRDM
  184. d:\path\GRDM
  185. d:\path\MRDM
  186.  
  187. Line 1    :the # of entries listed, in this case 3 display files are listed.
  188.            The two files can have a different number of entries.
  189.  
  190. Lines 2-# :the BASENAMEs of the display files. You can have Sec, Graph, &
  191.            Language specific files as well, but you only enter the BASENAME
  192.            of the file on these lines. Path's must be included.
  193.            The number of entries and the number defined on line 1 must match.
  194.  
  195.  
  196.  
  197. ╔════════════════════════════════════════════════════════════════════════════╗
  198. ║ Menu Display files                                                         ║
  199. ╚════════════════════════════════════════════════════════════════════════════╝
  200.  
  201. These are the files that you create. Think of them as "pages".
  202. The BRDUP/DOWN.PPEs "flip the pages". The BRDM.PPE "displays the pages".
  203. The filenames can have any name you choose. You can also have Sec, Graph,
  204. and Language specific files so you should keep the names short.
  205.  
  206. One "page" is displayed until the user "flips" the "page". Then that "page"
  207. is used until they "flip" the page again.
  208.  
  209. ╔════════════════════════════════════════════════════════════════════════════╗
  210. ║ Support/Latest versions                                                    ║
  211. ╚════════════════════════════════════════════════════════════════════════════╝
  212.  
  213. Support and the latest versions can be found on the support BBS.
  214. Latest versions are also uploaded to Salt Air BBS.
  215.  
  216. Herbert Bushong
  217. Blackbeard's BBS - (318) 468-3385  USR Courier D/S V.34+
  218.  
  219. Support can also be obtained by contacting the author at any of the following
  220. addresses:
  221.  
  222. herbert.bushong@bbread.pecan.com
  223. sysop@1:19/19
  224. or on Intelec or U'NI-net
  225.  
  226.  
  227.